home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / internet / sftp122.zip / README.TXT < prev    next >
Text File  |  1996-03-11  |  16KB  |  301 lines

  1. Welcome to S-FTP version 1.22 (or simple FTP)!
  2. .
  3. The author of this software is Keith Cotroneo. I call S-FTP Week-End-Ware
  4. ....because I really only have time to work on it during the week ends.
  5. .
  6. I am a Dean at a college in Oregon. Computers are a hobby of mine and lately
  7. I have spent some time on the Internet. The FTP utilities that I have tried
  8. have not suited my needs very well and Web browser don't work well for batch
  9. downloads. So I wrote this program for my own use.
  10. .
  11. What I wanted was something that would allow me to:
  12. .
  13.         *logon the popular ftp sites without hassle
  14.         *read .txt information about files in the directories easily
  15.         *perform batch downloads
  16.         *do an occasional upload
  17. .
  18. S-FTP does those things for me.
  19. .
  20. If it works for you, you are welcome to use it with the following provisions:
  21. .
  22.         1) There is absolutely no warranty with this software. You use it
  23.         completely at your own risk. This means that you agree that if you
  24.         use the software and it somehow screws up your system or you lose files,
  25.         that is your problem, not mine.
  26.         2) You understand that this software was developed using the RXFTP
  27.         package and agree to the additional license arrangements listed in the
  28.         license.txt file. Also, thanks to Jeff Glatt for Filerexx!
  29.         3) You MUST register after 15 days of use of this product. To do so,
  30.         send me email or snail mail telling me your name, address, email
  31.         address, and then please provide comments on how I should improve the
  32.         product. I *do* use suggestions to make changes. I can be reached below:
  33. .
  34.                         cotroneo@mailman.tvcc.cc.or.us
  35.                               or
  36.                         Keith Cotroneo
  37.                         661 SW 5th St.
  38.                         Ontario, OR 97914
  39.         4) If you distribute the package to others, you must give them the whole
  40.         Zip file.
  41.         5) You may not sell this software product to anyone.
  42. .
  43. .
  44. Changes in S-FTP since version 1.00:
  45.         1) Text files in the Directory List are now loaded to the viewer by
  46.         single clicking on the file to highlight it and then clicking the view
  47.         push button.
  48.         2) The Download List may now be populated from a viewed text file. This
  49.         works for files such as the Hobbes 00index.txt files. For this function
  50.         to work, the filename must be in the first position in the line of the
  51.         text file.
  52.         3) While files are downloading, you can now continue to populate the
  53.         download list box. You can download files while you are viewing the
  54.         directory list or 00index.txt files in the viewer and continue to
  55.         transfer file names to the Download List. Files will be downloaded in
  56.         the order of transfer to the download list.
  57.         4) Lengthy processes, such as logon and downloading are now placed
  58.         in separate threads. This makes the application much more responsive
  59.         and doesn't lock the application while processes are completed.
  60.         5) Added download path setting and config menu option.
  61.         6) Added Delete Host and Add Host buttons to allow configuring the
  62.         host list.
  63.         7) Added several progress indicators to tell the user what is happening.
  64.         8) S-FTP will now download files from outside the current remote
  65.         directory. You can build the download list from various directories
  66.         or 00index.txt files. The download list will remember paths to those
  67.         files and retrieve them when you download.
  68.         9) Added capability to configure host user name, password, default
  69.         directory.
  70.         10) Improved the logon process. It is more streamlined and provides
  71.         better progress reporting.
  72. v1.05
  73.         11) Added upload capability.
  74. v1.06
  75.         12) Added capability to resize the main SFTP window.
  76.         13) Added audible beep to signify completion of download list.
  77.         14) Added date/time sort button for directory list.
  78.         15) Added auto date/time sorting check box for auto sorting
  79.         whenever the directory list is updated.
  80.         16) Added double click .txt files to viewer check box option.
  81.         17) Changed the directory list default font to system monospace.
  82.         *NOTE: all of the 1.06 changes were made at the request of users.
  83.                I have more and I am working on them.
  84. v1.07
  85.         18) Fixed the date sorting routine. It didn't work right. Now if
  86.         the Date Sort box is checked, the directory list will be downloaded
  87.         in descending date order.
  88. v1.08
  89.         19) Added back up directory button <<.
  90.         20) Increased directory text box character capacity.
  91. v1.09   21) Added capability to save window size and position.
  92. v1.09a  22) Fixed a compatibility problem with earlier versions and the
  93.         path.txt file. Users of previous versions can now keep their old
  94.         path.txt file, whereas v1.09 required replacing it.
  95. v1.10   23) Fixed a problem with the progress indicator not functioning on
  96.         FAT partitions. Thank you to Jeff Glatt for his wonderful FILEREXX
  97.         utilities. The FILEREXX.DLL is now required for SFTP.
  98. v1.20   24) Improved download progress indicator to provide percent
  99.         statistic.
  100.         25) Added download progress indicator for the viewer.
  101.         26) Added aliases, now you can have multiple aliases with different
  102.         download directories, user and password for each  host.
  103.         27) Changed behavior in the host listbox so that a double click
  104.         on the host alias automatically logs on the the remote host.
  105.         28) Added quick list type function to quickly add the current host
  106.         and directory to the alias list. Clicking on a Add Host now
  107.         automatically sets up the current directory with an alias in the
  108.         add host option window.
  109.         29) Added direct host logging. Typing a host with a directory, ie.
  110.         hobbes.nmsu.edu/incoming in the host edit box and then clicking on
  111.         logon will automatically logon to the host without having to set
  112.         up a specific host alias.
  113.         30) Changed the directory listbox behavior so that you can press
  114.         enter or  double click to select an entry.
  115.         31) Added the capability to press the escape key in the viewer to
  116.         close the viewer window.
  117.         32) Fixed the download routine so that it adjusts filenames to
  118.         conform to the 8.3 requirement when downloading to a FAT drive.
  119.         33) Made adjustments to the multi-threading components to
  120.         improve responsiveness.
  121. v1.21   34) Changed the behavior of sftp so that it no longer pops to the
  122.         foreground after download completion.
  123.         35) Added automatic logging. Now all downloads are logged to a file
  124.         called sftplog that is located in the sftp directory. This log is
  125.         useful if you want to check to see from which host and directory
  126.         you received a particular file. You can also logon to a host from the
  127.         log file by selecting log and view log from the menu and then double
  128.         clicking on an entry in the viewer.
  129.         36) Added Host Edit button.
  130.         37) Changed alias list action so that a single click on the host list
  131.         will display the host name and logon directory.
  132.         38) Changed the host add/edit window so that a single click instead
  133.         of a double click in the alias list will display its settings.
  134. v1.22   39) Added support for the lr style directory entries.
  135.         40) Fixed problem with the alias/host editor.
  136.         41) Added abort function (it is slow, but works for long downloads).
  137.         42) Cleaned up a few problems with the text messages on the interface.
  138.         43) Fixed a problem with the logoff/logon routines.
  139. .
  140. To use S-FTP:
  141.         1) Unzip the S-FTP.ZIP file to the directory in which you want the
  142.         product to reside.
  143.         2) Copy the files rxftp.dll and filerexx.dll to a directory in your
  144.         DLL path.
  145.         3) Edit the hosts.txt file to include any hosts that you visit.
  146.         4) Create an object on the desktop if you want one.
  147.         5) Start your tcp client or internet connection.
  148.         6) Run S-Ftp by typing sftp at the command prompt or by clicking the object.
  149.         7) Click on the Config menu, choose Path, type in download path setting in
  150.         the textbox, click change button, double click upper left of window to
  151.         close.
  152.         8) Double click on the host name you wish to visit.
  153.         9) Click the logon button and wait for the connection. When connected,
  154.         the root directory listing will load into the directory list box.
  155.         10) Review limitations section at end of this help file.
  156. .
  157. To add new hosts and aliases:
  158.         1) Click Add Host.
  159.         2) A window pops up, complete the required information for the Host.
  160.         3) Click the Add Button to save the information.
  161.         4) Click Done to exit the window.
  162. .
  163. To change a hosts settings:
  164.         1) Single click on the alias in the alias list box.
  165.         2) Click the Edit button.
  166.         3) Modify the alias information in the host settings window.
  167.         4) Click Change.
  168.         5) Click Done to exit the window.
  169. .
  170. To quick add new hosts:
  171.         1) When you are in a directory of a remote host, click Add. The
  172.         Host settings window will automatically append the directory to the old
  173.         alias name to let you quickly set up the new host alias.
  174.         2) Click Add.
  175.         3) Click Done.
  176. .
  177. To change other hosts settings while in the Host Settings window:
  178.         1) Use the listbox to select the host alias in the host settings window.
  179.         2) Change the information as needed.
  180.         3) Click Change and then Done.
  181. .
  182. To delete hosts:
  183.         1) Highlight the host alias in the Host listbox that you want to delete
  184.         by single clicking on it. Click the Delete Host button. The host is
  185.         removed from the listbox.
  186. .
  187. To logon to a remote host:
  188.         1) Double click on the alias in the host listbox.
  189. .
  190. To change a directory:
  191.         1) Double click on the directory in the directory listbox to which you
  192.         want to change (english, can you believe it?), or enter the directory
  193.         in the Directory textbox and click on the Dir Button.
  194. .
  195. To back up to a parent directory:
  196.         1) Click the << button.
  197. .
  198. To date/time sort a directory listing:
  199.         1) Click the Date Sort check box.
  200.         2) Now, when directory lists are downloaded, they will be sorted in
  201.         descending date order.
  202.         * This function was requested by users to make it easy to check an
  203.         /incoming directory and see the newest files first.
  204. .
  205. To download files:
  206.         1) Double click on the file(s) in the directory listbox that you
  207.         want to download.
  208.         2) Each file will be transfered to the download listbox.
  209.         3) When you are done choosing files, click on the download button
  210.         to begin receiving the files.They will be placed in the directory
  211.         specified by your path configuration in the config menu.
  212.         4) When the list is cleared, all your files have been transfered.
  213.         *Note: effective in version 1.02, you may continue to build the
  214.         download list while downloading is in progress. New files added to
  215.         the download list while downloading will be transfered in the
  216.         order appended to the download list.
  217.                                 or
  218.         If you are downloading from a site, such as Hobbes, that maintains
  219.         file listing descriptions in text files (ie. 00index.txt), you can
  220.         add files to the Download List from a viewed text file. To do so:
  221.         1) Highlight the text file (ie. 00index.txt) in the Directory List
  222.         by single clicking on it.
  223.         2) Click the View button to load the text file into the viewer.
  224.         3) Double click on the files in the viewer that you wish to transfer
  225.         to the Download list.
  226.         *Note: effective in version 1.02, you may continue to build the
  227.         download list while downloading is in progress. New files added to
  228.         the download list while downloading.
  229. .
  230. To delete files from the download list:
  231.         1) Double click on the files in the Download Listbox that you want to
  232.         remove.
  233.                         or
  234.         3) Click on the Clear List button to remove all files.
  235. .
  236. To view text files on a remote site:
  237.         1) Single click on a text file in the directory listbox to highlight the
  238.         file that you want to view.
  239.         2) Click the View push button.
  240.         *Note the view push button will only act on files in the directory list.
  241.         Files in the Download list are not affected.
  242.                         or
  243.         3) Click the .txt Dblclick check box.
  244.         4) With the .txt Dblclick check box selected, a double click on a file
  245.         in the directory list with a .txt extension will automatically load
  246.         the file to the viewer. This feature was requested by a user.
  247. .
  248. To upload a file:
  249.         1) Single click on the Upload menu.
  250.         2) Single click on either Ascii (if text file) or Binary (executable).
  251.         3) Choose the file from the file dialog. Click OK or double click on
  252.         the file.
  253.         4) In the next upload window, click Yes.
  254.         5) Wait for the upload to conclude. No file progress checking is shown.
  255.         6) If the upload is successful, the directory list will be downloaded.
  256. .
  257. To conduct simultaneous uploads, downloads, etc.:
  258.         1) Begin your first upload or download with SFTP.
  259.         2) Load a second copy of SFTP.
  260.         3) Initiate your second upload or download.
  261. .
  262. To save window size and position:
  263.         1) Click Config on the menu.
  264.         2) Click Save Size and Position.
  265. .
  266. To view the download log:
  267.         1) Click Log on the menu.
  268.         2) Click View.
  269.                 or
  270.         3) Open the sftplog file in the sftp directory with a text editor.
  271. .
  272. To automatically logon to a file in the log:
  273.         1) Click Log on the menu.
  274.         2) Click View.
  275.         3) Double click on the host entry to which you wish to logon.
  276. .
  277. To abort a long download:
  278.         1) Click the abort button.
  279.         2) Click yest at the next window prompt.
  280.         3) Wait. This process is slow, usually takes about 164k on my system
  281.         with a 28.8 modem to kill the download. It is the best I can figure
  282.         out right now. Suggestions are welcome.
  283. .
  284. Limitations:
  285.         1) One user reported difficulty downloading files from a direct network
  286.         connection. If you use this software directly of a network, instead of
  287.         through a modem, please let me know how it works for you off the
  288.         network.
  289.         2) Currently, SFTP is set up to handle Unix servers. Other server types
  290.         are not supported.
  291.         3) Still have not figured out how to kill the download thread without
  292.         closing the application. I believe there is a problem in the Vispro/rexx
  293.         that does not handle this aspect of multi-threading properly. If anyone
  294.         has suggestions please contact me.
  295. .
  296. Well, that is pretty much it. Let me know how things go.
  297. .
  298. Keith Cotroneo
  299. cotroneo@mailman.tvcc.cc.or.us
  300. Updated March 11, 1996
  301.